Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Alternate Tracks

SetMovieLanguage

The SetMovieLanguage function allows your application to specify a movie's language. You specify the language by supplying the appropriate language or region code (see Inside Macintosh: Text for more information on language and region codes).

pascal void SetMovieLanguage (Movie theMovie, long language);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

language

Specifies the movie's language or region code.

DESCRIPTION

The Movie Toolbox examines the movie's alternate groups and selects and enables appropriate tracks. If the Movie Toolbox cannot find an appropriate track, it does not change the movie's language.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid